markdown 语法

作者 wenhan wu

1. 字体

1.1 标题

在markdown中,标题我们往往采用(# + 空格 + 标题内容),建议在#后加上一个空格,标题最多只支持前六级标题,标题都位于每一行的行首,不要使用多余的空格。

1.2 粗体和斜体

粗体使用两个*进行包裹

斜体使用一个*进行包裹

我是粗体

我是斜体

2. 段落与换行

如果行与行之间没有空行,则会被视为同一段落,

如果行与行之间空行,则会被视为不同的段落。

通常每行不应该超过80个字符,为了提高可读性,在引入url时换行。

3. 列表

3.1 有序列表的语法是

数字序号+英文句号+空格+列表内容

  1. 有序列表
  2. 有序列表
  3. 有序列表

3.2 无序列表的语法是

*/+/- +空格+列表内容

  • 无序列表
  • 无序列表
  • 无序列表

3.3 嵌套列表

  • 第一层列表
    • 第二层列表
      • 第三层列表

语法是+ 第一层列表

TAB + 第二层列表

TAB + TAB + 第三层列表

列表之间可以相互嵌套,有序和无序之间也可以相互嵌套

4. 分隔线

分隔线至少使用3个以上的*/-/_来标记

行内不能有其他的字符

可以在标记符中间加上空格

星号




减号




下划线




5. 链接

链接文字

Github

2. 行内代码与代码块

行内代码使用`进行包裹

R/python

代码块以Tab键和4个空格开头

R
python

3. 表格

表格的语法如下:

|biaotou 1 |biaotou 2 |biaotou 3 |
|----------|----------|----------|
|content 1 |content 2 |content 3 |
|     a    |     b    |     c    |

实际的效果如下

biaotou 1 biaotou 2 biaotou 3
content 1 content 2 content 3
a b c

对于表格的问题,我们在markdown中尽量使用较小的表格,复杂的表格将变得难以维护。

4.测试各种各样常用的颜色

<font color = red>我是红色
<font color = coral>我是珊瑚色
<font color = Firebrick>我是深红色
<font color = deepskyblue>我是天空蓝
<font color = deeppink>我是深粉色

我是红色
我是红色
* 我是红色*
我是红色我是黄色
我是珊瑚色
我是砖红色
我是天空蓝色
我是深粉色